home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / pbmpl91d.zip / PBMPLUS / MAN / PGMNORM.MAN < prev    next >
Text File  |  1993-01-08  |  2KB  |  72 lines
  1.  
  2.  
  3. pgmnorm(1)                 Unix Programmer's Manual                 pgmnorm(1)
  4.  
  5.  
  6. NAME
  7.      pgmnorm - normalize the contrast in a portable graymap
  8.  
  9. SYNOPSIS
  10.      pgmnorm [-bpercent N | -bvalue N] [-wpercent N | -wvalue N] [pgmfile]
  11.                         -           -             -           -   -------
  12.  
  13. DESCRIPTION
  14.      Reads a portable graymap as input.  Normalizes the  contrast  by  forcing
  15.      the  lightest  pixels to white, the darkest pixels to black, and linearly
  16.      rescaling the ones in between; and produces a portable graymap as output.
  17.  
  18. OPTIONS
  19.  
  20.      By default, the darkest 2 percent of all pixels are mapped to black,  and
  21.      the  lightest  1  percent  are  mapped  to white.  You can override these
  22.      percentages by using the  -bpercent  and  -wpercent  flags,  or  you  can
  23.      specify  the  exact  pixel  values  to be mapped by using the -bvalue and
  24.      -wvalue flags.  Appropriate numbers for the flags can be gotten from  the
  25.      pgmhist  tool.   If  you  just  want to enhance the contrast, then choose
  26.      -------
  27.      values at elbows in the histogram; e.g. if value 29 represents 3% of  the
  28.      image  but value 30 represents 20%, choose 30 for bvalue.  If you want to
  29.                                                        ------
  30.      lighten the image, then set bvalue to 0  and  just  fiddle  with  wvalue;
  31.                                  ------                                ------
  32.      similarly,  to  darken  the  image,  set  wvalue  to maxval and play with
  33.                                                ------
  34.      bvalue.
  35.      ------
  36.  
  37.      All flags can be abbreviated to their shortest unique prefix.
  38.  
  39. SEE ALSO
  40.      pgmhist(1), pgm(5)
  41.  
  42. AUTHOR
  43.      Partially based on the fbnorm filter in Michael Mauldin's "Fuzzy  Pixmap"
  44.      package.
  45.  
  46.      Copyright (C) 1989 by Jef Poskanzer.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                               28 February 1989                               1
  71.  
  72.